<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>create_cam_pose_look_at_point [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_3dmatching.html">3D 匹配</a> / <a href="toc_3dmatching_shapebased.html">Shape-Based</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">create_cam_pose_look_at_point</span><span data-if="c" style="display:none;">T_create_cam_pose_look_at_point</span><span data-if="cpp" style="display:none;">CreateCamPoseLookAtPoint</span><span data-if="dotnet" style="display:none;">CreateCamPoseLookAtPoint</span><span data-if="python" style="display:none;">create_cam_pose_look_at_point</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">create_cam_pose_look_at_point</span><span data-if="c" style="display:none;">T_create_cam_pose_look_at_point</span><span data-if="cpp" style="display:none;">CreateCamPoseLookAtPoint</span><span data-if="dotnet" style="display:none;">CreateCamPoseLookAtPoint</span><span data-if="python" style="display:none;">create_cam_pose_look_at_point</span></code> — Create a 3D camera pose from camera center and viewing direction.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>create_cam_pose_look_at_point</b>( :  : <a href="#CamPosX"><i>CamPosX</i></a>, <a href="#CamPosY"><i>CamPosY</i></a>, <a href="#CamPosZ"><i>CamPosZ</i></a>, <a href="#LookAtX"><i>LookAtX</i></a>, <a href="#LookAtY"><i>LookAtY</i></a>, <a href="#LookAtZ"><i>LookAtZ</i></a>, <a href="#RefPlaneNormal"><i>RefPlaneNormal</i></a>, <a href="#CamRoll"><i>CamRoll</i></a> : <a href="#CamPose"><i>CamPose</i></a>)</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>T_create_cam_pose_look_at_point</b>(const Htuple <a href="#CamPosX"><i>CamPosX</i></a>, const Htuple <a href="#CamPosY"><i>CamPosY</i></a>, const Htuple <a href="#CamPosZ"><i>CamPosZ</i></a>, const Htuple <a href="#LookAtX"><i>LookAtX</i></a>, const Htuple <a href="#LookAtY"><i>LookAtY</i></a>, const Htuple <a href="#LookAtZ"><i>LookAtZ</i></a>, const Htuple <a href="#RefPlaneNormal"><i>RefPlaneNormal</i></a>, const Htuple <a href="#CamRoll"><i>CamRoll</i></a>, Htuple* <a href="#CamPose"><i>CamPose</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>CreateCamPoseLookAtPoint</b>(const HTuple&amp; <a href="#CamPosX"><i>CamPosX</i></a>, const HTuple&amp; <a href="#CamPosY"><i>CamPosY</i></a>, const HTuple&amp; <a href="#CamPosZ"><i>CamPosZ</i></a>, const HTuple&amp; <a href="#LookAtX"><i>LookAtX</i></a>, const HTuple&amp; <a href="#LookAtY"><i>LookAtY</i></a>, const HTuple&amp; <a href="#LookAtZ"><i>LookAtZ</i></a>, const HTuple&amp; <a href="#RefPlaneNormal"><i>RefPlaneNormal</i></a>, const HTuple&amp; <a href="#CamRoll"><i>CamRoll</i></a>, HTuple* <a href="#CamPose"><i>CamPose</i></a>)</code></p>
<p>
<code>static HPoseArray <a href="HPose.html">HPose</a>::<b>CreateCamPoseLookAtPoint</b>(const HTuple&amp; <a href="#CamPosX"><i>CamPosX</i></a>, const HTuple&amp; <a href="#CamPosY"><i>CamPosY</i></a>, const HTuple&amp; <a href="#CamPosZ"><i>CamPosZ</i></a>, const HTuple&amp; <a href="#LookAtX"><i>LookAtX</i></a>, const HTuple&amp; <a href="#LookAtY"><i>LookAtY</i></a>, const HTuple&amp; <a href="#LookAtZ"><i>LookAtZ</i></a>, const HTuple&amp; <a href="#RefPlaneNormal"><i>RefPlaneNormal</i></a>, const HTuple&amp; <a href="#CamRoll"><i>CamRoll</i></a>)</code></p>
<p>
<code>void <a href="HPose.html">HPose</a>::<b>CreateCamPoseLookAtPoint</b>(double <a href="#CamPosX"><i>CamPosX</i></a>, double <a href="#CamPosY"><i>CamPosY</i></a>, double <a href="#CamPosZ"><i>CamPosZ</i></a>, double <a href="#LookAtX"><i>LookAtX</i></a>, double <a href="#LookAtY"><i>LookAtY</i></a>, double <a href="#LookAtZ"><i>LookAtZ</i></a>, const HTuple&amp; <a href="#RefPlaneNormal"><i>RefPlaneNormal</i></a>, double <a href="#CamRoll"><i>CamRoll</i></a>)</code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>CreateCamPoseLookAtPoint</b>(<a href="HTuple.html">HTuple</a> <a href="#CamPosX"><i>camPosX</i></a>, <a href="HTuple.html">HTuple</a> <a href="#CamPosY"><i>camPosY</i></a>, <a href="HTuple.html">HTuple</a> <a href="#CamPosZ"><i>camPosZ</i></a>, <a href="HTuple.html">HTuple</a> <a href="#LookAtX"><i>lookAtX</i></a>, <a href="HTuple.html">HTuple</a> <a href="#LookAtY"><i>lookAtY</i></a>, <a href="HTuple.html">HTuple</a> <a href="#LookAtZ"><i>lookAtZ</i></a>, <a href="HTuple.html">HTuple</a> <a href="#RefPlaneNormal"><i>refPlaneNormal</i></a>, <a href="HTuple.html">HTuple</a> <a href="#CamRoll"><i>camRoll</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#CamPose"><i>camPose</i></a>)</code></p>
<p>
<code>static <a href="HPose.html">HPose[]</a> <a href="HPose.html">HPose</a>.<b>CreateCamPoseLookAtPoint</b>(<a href="HTuple.html">HTuple</a> <a href="#CamPosX"><i>camPosX</i></a>, <a href="HTuple.html">HTuple</a> <a href="#CamPosY"><i>camPosY</i></a>, <a href="HTuple.html">HTuple</a> <a href="#CamPosZ"><i>camPosZ</i></a>, <a href="HTuple.html">HTuple</a> <a href="#LookAtX"><i>lookAtX</i></a>, <a href="HTuple.html">HTuple</a> <a href="#LookAtY"><i>lookAtY</i></a>, <a href="HTuple.html">HTuple</a> <a href="#LookAtZ"><i>lookAtZ</i></a>, <a href="HTuple.html">HTuple</a> <a href="#RefPlaneNormal"><i>refPlaneNormal</i></a>, <a href="HTuple.html">HTuple</a> <a href="#CamRoll"><i>camRoll</i></a>)</code></p>
<p>
<code>void <a href="HPose.html">HPose</a>.<b>CreateCamPoseLookAtPoint</b>(double <a href="#CamPosX"><i>camPosX</i></a>, double <a href="#CamPosY"><i>camPosY</i></a>, double <a href="#CamPosZ"><i>camPosZ</i></a>, double <a href="#LookAtX"><i>lookAtX</i></a>, double <a href="#LookAtY"><i>lookAtY</i></a>, double <a href="#LookAtZ"><i>lookAtZ</i></a>, <a href="HTuple.html">HTuple</a> <a href="#RefPlaneNormal"><i>refPlaneNormal</i></a>, double <a href="#CamRoll"><i>camRoll</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>create_cam_pose_look_at_point</b>(<a href="#CamPosX"><i>cam_pos_x</i></a>: MaybeSequence[float], <a href="#CamPosY"><i>cam_pos_y</i></a>: MaybeSequence[float], <a href="#CamPosZ"><i>cam_pos_z</i></a>: MaybeSequence[float], <a href="#LookAtX"><i>look_at_x</i></a>: MaybeSequence[float], <a href="#LookAtY"><i>look_at_y</i></a>: MaybeSequence[float], <a href="#LookAtZ"><i>look_at_z</i></a>: MaybeSequence[float], <a href="#RefPlaneNormal"><i>ref_plane_normal</i></a>: Sequence[Union[str, float]], <a href="#CamRoll"><i>cam_roll</i></a>: MaybeSequence[float]) -&gt; Sequence[Union[int, float]]</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p>该算子 <code><span data-if="hdevelop" style="display:inline">create_cam_pose_look_at_point</span><span data-if="c" style="display:none">create_cam_pose_look_at_point</span><span data-if="cpp" style="display:none">CreateCamPoseLookAtPoint</span><span data-if="com" style="display:none">CreateCamPoseLookAtPoint</span><span data-if="dotnet" style="display:none">CreateCamPoseLookAtPoint</span><span data-if="python" style="display:none">create_cam_pose_look_at_point</span></code> creates a 3D
camera pose with respect to a world coordinate system based on two
points and the camera roll angle.
</p>
<p>The first of the two points defines the position of the optical
center of the camera in the world coordinate system, i.e., the
origin of the camera coordinate system. It is given by its three
coordinates <a href="#CamPosX"><i><code><span data-if="hdevelop" style="display:inline">CamPosX</span><span data-if="c" style="display:none">CamPosX</span><span data-if="cpp" style="display:none">CamPosX</span><span data-if="com" style="display:none">CamPosX</span><span data-if="dotnet" style="display:none">camPosX</span><span data-if="python" style="display:none">cam_pos_x</span></code></i></a>, <a href="#CamPosY"><i><code><span data-if="hdevelop" style="display:inline">CamPosY</span><span data-if="c" style="display:none">CamPosY</span><span data-if="cpp" style="display:none">CamPosY</span><span data-if="com" style="display:none">CamPosY</span><span data-if="dotnet" style="display:none">camPosY</span><span data-if="python" style="display:none">cam_pos_y</span></code></i></a>, and
<a href="#CamPosZ"><i><code><span data-if="hdevelop" style="display:inline">CamPosZ</span><span data-if="c" style="display:none">CamPosZ</span><span data-if="cpp" style="display:none">CamPosZ</span><span data-if="com" style="display:none">CamPosZ</span><span data-if="dotnet" style="display:none">camPosZ</span><span data-if="python" style="display:none">cam_pos_z</span></code></i></a>. The second of the two points defines the viewing
direction of the camera. It represents the point in the world
coordinate system at which the camera is to look.  It is also
specified by its three coordinates <a href="#LookAtX"><i><code><span data-if="hdevelop" style="display:inline">LookAtX</span><span data-if="c" style="display:none">LookAtX</span><span data-if="cpp" style="display:none">LookAtX</span><span data-if="com" style="display:none">LookAtX</span><span data-if="dotnet" style="display:none">lookAtX</span><span data-if="python" style="display:none">look_at_x</span></code></i></a>,
<a href="#LookAtY"><i><code><span data-if="hdevelop" style="display:inline">LookAtY</span><span data-if="c" style="display:none">LookAtY</span><span data-if="cpp" style="display:none">LookAtY</span><span data-if="com" style="display:none">LookAtY</span><span data-if="dotnet" style="display:none">lookAtY</span><span data-if="python" style="display:none">look_at_y</span></code></i></a>, and <a href="#LookAtZ"><i><code><span data-if="hdevelop" style="display:inline">LookAtZ</span><span data-if="c" style="display:none">LookAtZ</span><span data-if="cpp" style="display:none">LookAtZ</span><span data-if="com" style="display:none">LookAtZ</span><span data-if="dotnet" style="display:none">lookAtZ</span><span data-if="python" style="display:none">look_at_z</span></code></i></a>.  Consequently, the second
point lies on the z axis of the camera coordinate system.
</p>
<p>Finally, the remaining degree of freedom to be specified is a
rotation of the camera around its z axis, i.e., the roll angle of
the camera. To determine this rotation, the normal of a reference
plane can be specified in <a href="#RefPlaneNormal"><i><code><span data-if="hdevelop" style="display:inline">RefPlaneNormal</span><span data-if="c" style="display:none">RefPlaneNormal</span><span data-if="cpp" style="display:none">RefPlaneNormal</span><span data-if="com" style="display:none">RefPlaneNormal</span><span data-if="dotnet" style="display:none">refPlaneNormal</span><span data-if="python" style="display:none">ref_plane_normal</span></code></i></a>, which defines the
reference orientation of the camera. Finally, the camera roll angle
can be specified in <a href="#CamRoll"><i><code><span data-if="hdevelop" style="display:inline">CamRoll</span><span data-if="c" style="display:none">CamRoll</span><span data-if="cpp" style="display:none">CamRoll</span><span data-if="com" style="display:none">CamRoll</span><span data-if="dotnet" style="display:none">camRoll</span><span data-if="python" style="display:none">cam_roll</span></code></i></a>, which describes a rotation of
the camera around its z axis with respect to its reference
orientation.
</p>
<p>The reference plane can be seen as a plane in the world coordinate
system that is parallel to the x axis of the camera (in its
reference orientation, i.e., with a roll angle of 0). In an
alternative interpretation, the normal vector of the reference plane
projected onto the image plane points upwards, i.e., it is mapped to
the negative y axis of the camera coordinate system. The parameter
<a href="#RefPlaneNormal"><i><code><span data-if="hdevelop" style="display:inline">RefPlaneNormal</span><span data-if="c" style="display:none">RefPlaneNormal</span><span data-if="cpp" style="display:none">RefPlaneNormal</span><span data-if="com" style="display:none">RefPlaneNormal</span><span data-if="dotnet" style="display:none">refPlaneNormal</span><span data-if="python" style="display:none">ref_plane_normal</span></code></i></a> may take one of the following values:
</p>
<dl class="generic">


<dt><b><i><span data-if="hdevelop" style="display:inline">'x'</span><span data-if="c" style="display:none">"x"</span><span data-if="cpp" style="display:none">"x"</span><span data-if="com" style="display:none">"x"</span><span data-if="dotnet" style="display:none">"x"</span><span data-if="python" style="display:none">"x"</span></i>:</b></dt>
<dd>
<p>

The reference plane is the yz plane of the world coordinate
system. The projected x axis of the world coordinate system points
<em>upwards</em> in the image plane.
</p>
</dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'-x'</span><span data-if="c" style="display:none">"-x"</span><span data-if="cpp" style="display:none">"-x"</span><span data-if="com" style="display:none">"-x"</span><span data-if="dotnet" style="display:none">"-x"</span><span data-if="python" style="display:none">"-x"</span></i>:</b></dt>
<dd>
<p>

The reference plane is the yz plane of the world coordinate
system. The projected x axis of the world coordinate system points
<em>downwards</em> in the image plane.
</p>
</dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'y'</span><span data-if="c" style="display:none">"y"</span><span data-if="cpp" style="display:none">"y"</span><span data-if="com" style="display:none">"y"</span><span data-if="dotnet" style="display:none">"y"</span><span data-if="python" style="display:none">"y"</span></i>:</b></dt>
<dd>
<p>

The reference plane is the xz plane of the world coordinate
system. The projected y axis of the world coordinate system points
<em>upwards</em> in the image plane.
</p>
</dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'-y'</span><span data-if="c" style="display:none">"-y"</span><span data-if="cpp" style="display:none">"-y"</span><span data-if="com" style="display:none">"-y"</span><span data-if="dotnet" style="display:none">"-y"</span><span data-if="python" style="display:none">"-y"</span></i>:</b></dt>
<dd>
<p>

The reference plane is the xz plane of the world coordinate
system. The projected y axis of the world coordinate system points
<em>downwards</em> in the image plane.
</p>
</dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'z'</span><span data-if="c" style="display:none">"z"</span><span data-if="cpp" style="display:none">"z"</span><span data-if="com" style="display:none">"z"</span><span data-if="dotnet" style="display:none">"z"</span><span data-if="python" style="display:none">"z"</span></i>:</b></dt>
<dd>
<p>

The reference plane is the xy plane of the world coordinate
system. The projected z axis of the world coordinate system points
<em>upwards</em> in the image plane.
</p>
</dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'-z'</span><span data-if="c" style="display:none">"-z"</span><span data-if="cpp" style="display:none">"-z"</span><span data-if="com" style="display:none">"-z"</span><span data-if="dotnet" style="display:none">"-z"</span><span data-if="python" style="display:none">"-z"</span></i>:</b></dt>
<dd>
<p>

The reference plane is the xy plane of the world coordinate
system. The projected z axis of the world coordinate system points
<em>downwards</em> in the image plane.
</p>
</dd>
</dl>
<p>Alternatively to the above values, an arbitrary normal vector can be
specified in <a href="#RefPlaneNormal"><i><code><span data-if="hdevelop" style="display:inline">RefPlaneNormal</span><span data-if="c" style="display:none">RefPlaneNormal</span><span data-if="cpp" style="display:none">RefPlaneNormal</span><span data-if="com" style="display:none">RefPlaneNormal</span><span data-if="dotnet" style="display:none">refPlaneNormal</span><span data-if="python" style="display:none">ref_plane_normal</span></code></i></a>, which is not restricted to the
coordinate axes. For this, a tuple of three values representing the
three components of the normal vector must be passed.
</p>
<p>Note that the position of the optical center and the point at which
the camera looks must differ from each other. Furthermore, the
normal vector of the reference plane and the z axis of the camera
must not be parallel.  Otherwise, the camera pose is not
well-defined.
</p>
<p><code><span data-if="hdevelop" style="display:inline">create_cam_pose_look_at_point</span><span data-if="c" style="display:none">create_cam_pose_look_at_point</span><span data-if="cpp" style="display:none">CreateCamPoseLookAtPoint</span><span data-if="com" style="display:none">CreateCamPoseLookAtPoint</span><span data-if="dotnet" style="display:none">CreateCamPoseLookAtPoint</span><span data-if="python" style="display:none">create_cam_pose_look_at_point</span></code> is particularly useful if a 3D
object model or a 3D shape model should be visualized from a certain
camera position. In this case, the pose that is created by
<code><span data-if="hdevelop" style="display:inline">create_cam_pose_look_at_point</span><span data-if="c" style="display:none">create_cam_pose_look_at_point</span><span data-if="cpp" style="display:none">CreateCamPoseLookAtPoint</span><span data-if="com" style="display:none">CreateCamPoseLookAtPoint</span><span data-if="dotnet" style="display:none">CreateCamPoseLookAtPoint</span><span data-if="python" style="display:none">create_cam_pose_look_at_point</span></code> can be passed to
<a href="project_object_model_3d.html"><code><span data-if="hdevelop" style="display:inline">project_object_model_3d</span><span data-if="c" style="display:none">project_object_model_3d</span><span data-if="cpp" style="display:none">ProjectObjectModel3d</span><span data-if="com" style="display:none">ProjectObjectModel3d</span><span data-if="dotnet" style="display:none">ProjectObjectModel3d</span><span data-if="python" style="display:none">project_object_model_3d</span></code></a> or <a href="project_shape_model_3d.html"><code><span data-if="hdevelop" style="display:inline">project_shape_model_3d</span><span data-if="c" style="display:none">project_shape_model_3d</span><span data-if="cpp" style="display:none">ProjectShapeModel3d</span><span data-if="com" style="display:none">ProjectShapeModel3d</span><span data-if="dotnet" style="display:none">ProjectShapeModel3d</span><span data-if="python" style="display:none">project_shape_model_3d</span></code></a>,
respectively.
</p>
<p>It is also possible to pass tuples of different length for different
input parameters.  In this case, internally the maximum number of
parameter values over all input control parameters is computed.
This number is taken as the number of output camera poses.  Then,
all input parameters can contain a single value or the same number
of values as output camera poses.  In the first case, the single
value is used for the computation of all camera poses, while in the
second case the respective value of the element in the parameter is
used for the computation of the corresponding camera pose.</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  <li>未经并行化处理。</li>
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="CamPosX" class="parname"><b><code><span data-if="hdevelop" style="display:inline">CamPosX</span><span data-if="c" style="display:none">CamPosX</span><span data-if="cpp" style="display:none">CamPosX</span><span data-if="com" style="display:none">CamPosX</span><span data-if="dotnet" style="display:none">camPosX</span><span data-if="python" style="display:none">cam_pos_x</span></code></b> (input_control)  </span><span>real(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">MaybeSequence[float]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (real)</span><span data-if="dotnet" style="display:none"> (<i>double</i>)</span><span data-if="cpp" style="display:none"> (<i>double</i>)</span><span data-if="c" style="display:none"> (<i>double</i>)</span></span>
</div>
<p class="pardesc">X coordinate of the optical center of the camera.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="CamPosY" class="parname"><b><code><span data-if="hdevelop" style="display:inline">CamPosY</span><span data-if="c" style="display:none">CamPosY</span><span data-if="cpp" style="display:none">CamPosY</span><span data-if="com" style="display:none">CamPosY</span><span data-if="dotnet" style="display:none">camPosY</span><span data-if="python" style="display:none">cam_pos_y</span></code></b> (input_control)  </span><span>real(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">MaybeSequence[float]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (real)</span><span data-if="dotnet" style="display:none"> (<i>double</i>)</span><span data-if="cpp" style="display:none"> (<i>double</i>)</span><span data-if="c" style="display:none"> (<i>double</i>)</span></span>
</div>
<p class="pardesc">Y coordinate of the optical center of the camera.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="CamPosZ" class="parname"><b><code><span data-if="hdevelop" style="display:inline">CamPosZ</span><span data-if="c" style="display:none">CamPosZ</span><span data-if="cpp" style="display:none">CamPosZ</span><span data-if="com" style="display:none">CamPosZ</span><span data-if="dotnet" style="display:none">camPosZ</span><span data-if="python" style="display:none">cam_pos_z</span></code></b> (input_control)  </span><span>real(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">MaybeSequence[float]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (real)</span><span data-if="dotnet" style="display:none"> (<i>double</i>)</span><span data-if="cpp" style="display:none"> (<i>double</i>)</span><span data-if="c" style="display:none"> (<i>double</i>)</span></span>
</div>
<p class="pardesc">Z coordinate of the optical center of the camera.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="LookAtX" class="parname"><b><code><span data-if="hdevelop" style="display:inline">LookAtX</span><span data-if="c" style="display:none">LookAtX</span><span data-if="cpp" style="display:none">LookAtX</span><span data-if="com" style="display:none">LookAtX</span><span data-if="dotnet" style="display:none">lookAtX</span><span data-if="python" style="display:none">look_at_x</span></code></b> (input_control)  </span><span>real(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">MaybeSequence[float]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (real)</span><span data-if="dotnet" style="display:none"> (<i>double</i>)</span><span data-if="cpp" style="display:none"> (<i>double</i>)</span><span data-if="c" style="display:none"> (<i>double</i>)</span></span>
</div>
<p class="pardesc">X coordinate of the 3D point to which the camera
is directed.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="LookAtY" class="parname"><b><code><span data-if="hdevelop" style="display:inline">LookAtY</span><span data-if="c" style="display:none">LookAtY</span><span data-if="cpp" style="display:none">LookAtY</span><span data-if="com" style="display:none">LookAtY</span><span data-if="dotnet" style="display:none">lookAtY</span><span data-if="python" style="display:none">look_at_y</span></code></b> (input_control)  </span><span>real(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">MaybeSequence[float]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (real)</span><span data-if="dotnet" style="display:none"> (<i>double</i>)</span><span data-if="cpp" style="display:none"> (<i>double</i>)</span><span data-if="c" style="display:none"> (<i>double</i>)</span></span>
</div>
<p class="pardesc">Y coordinate of the 3D point to which the camera
is directed.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="LookAtZ" class="parname"><b><code><span data-if="hdevelop" style="display:inline">LookAtZ</span><span data-if="c" style="display:none">LookAtZ</span><span data-if="cpp" style="display:none">LookAtZ</span><span data-if="com" style="display:none">LookAtZ</span><span data-if="dotnet" style="display:none">lookAtZ</span><span data-if="python" style="display:none">look_at_z</span></code></b> (input_control)  </span><span>real(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">MaybeSequence[float]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (real)</span><span data-if="dotnet" style="display:none"> (<i>double</i>)</span><span data-if="cpp" style="display:none"> (<i>double</i>)</span><span data-if="c" style="display:none"> (<i>double</i>)</span></span>
</div>
<p class="pardesc">Z coordinate of the 3D point to which the camera
is directed.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="RefPlaneNormal" class="parname"><b><code><span data-if="hdevelop" style="display:inline">RefPlaneNormal</span><span data-if="c" style="display:none">RefPlaneNormal</span><span data-if="cpp" style="display:none">RefPlaneNormal</span><span data-if="com" style="display:none">RefPlaneNormal</span><span data-if="dotnet" style="display:none">refPlaneNormal</span><span data-if="python" style="display:none">ref_plane_normal</span></code></b> (input_control)  </span><span>string-array <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[Union[str, float]]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string / </span><span data-if="hdevelop" style="display:inline">real)</span><span data-if="dotnet" style="display:none"> (<i>string</i> / </span><span data-if="dotnet" style="display:none">double)</span><span data-if="cpp" style="display:none"> (<i>HString</i> / </span><span data-if="cpp" style="display:none">double)</span><span data-if="c" style="display:none"> (<i>char*</i> / </span><span data-if="c" style="display:none">double)</span></span>
</div>
<p class="pardesc">Normal vector of the reference plane (points up).</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'-y'</span>
    <span data-if="c" style="display:none">"-y"</span>
    <span data-if="cpp" style="display:none">"-y"</span>
    <span data-if="com" style="display:none">"-y"</span>
    <span data-if="dotnet" style="display:none">"-y"</span>
    <span data-if="python" style="display:none">"-y"</span>
</p>
<p class="pardesc"><span class="parcat">List of values:
      </span><span data-if="hdevelop" style="display:inline">'-x'</span><span data-if="c" style="display:none">"-x"</span><span data-if="cpp" style="display:none">"-x"</span><span data-if="com" style="display:none">"-x"</span><span data-if="dotnet" style="display:none">"-x"</span><span data-if="python" style="display:none">"-x"</span>, <span data-if="hdevelop" style="display:inline">'-y'</span><span data-if="c" style="display:none">"-y"</span><span data-if="cpp" style="display:none">"-y"</span><span data-if="com" style="display:none">"-y"</span><span data-if="dotnet" style="display:none">"-y"</span><span data-if="python" style="display:none">"-y"</span>, <span data-if="hdevelop" style="display:inline">'-z'</span><span data-if="c" style="display:none">"-z"</span><span data-if="cpp" style="display:none">"-z"</span><span data-if="com" style="display:none">"-z"</span><span data-if="dotnet" style="display:none">"-z"</span><span data-if="python" style="display:none">"-z"</span>, <span data-if="hdevelop" style="display:inline">'x'</span><span data-if="c" style="display:none">"x"</span><span data-if="cpp" style="display:none">"x"</span><span data-if="com" style="display:none">"x"</span><span data-if="dotnet" style="display:none">"x"</span><span data-if="python" style="display:none">"x"</span>, <span data-if="hdevelop" style="display:inline">'y'</span><span data-if="c" style="display:none">"y"</span><span data-if="cpp" style="display:none">"y"</span><span data-if="com" style="display:none">"y"</span><span data-if="dotnet" style="display:none">"y"</span><span data-if="python" style="display:none">"y"</span>, <span data-if="hdevelop" style="display:inline">'z'</span><span data-if="c" style="display:none">"z"</span><span data-if="cpp" style="display:none">"z"</span><span data-if="com" style="display:none">"z"</span><span data-if="dotnet" style="display:none">"z"</span><span data-if="python" style="display:none">"z"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="CamRoll" class="parname"><b><code><span data-if="hdevelop" style="display:inline">CamRoll</span><span data-if="c" style="display:none">CamRoll</span><span data-if="cpp" style="display:none">CamRoll</span><span data-if="com" style="display:none">CamRoll</span><span data-if="dotnet" style="display:none">camRoll</span><span data-if="python" style="display:none">cam_roll</span></code></b> (input_control)  </span><span>angle.rad(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">MaybeSequence[float]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (real)</span><span data-if="dotnet" style="display:none"> (<i>double</i>)</span><span data-if="cpp" style="display:none"> (<i>double</i>)</span><span data-if="c" style="display:none"> (<i>double</i>)</span></span>
</div>
<p class="pardesc">Camera roll angle.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>0</p>
</div>
  <div class="par">
<div class="parhead">
<span id="CamPose" class="parname"><b><code><span data-if="hdevelop" style="display:inline">CamPose</span><span data-if="c" style="display:none">CamPose</span><span data-if="cpp" style="display:none">CamPose</span><span data-if="com" style="display:none">CamPose</span><span data-if="dotnet" style="display:none">camPose</span><span data-if="python" style="display:none">cam_pose</span></code></b> (output_control)  </span><span>pose(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HPose.html">HPose</a>, </span><span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[Union[int, float]]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (real / </span><span data-if="hdevelop" style="display:inline">integer)</span><span data-if="dotnet" style="display:none"> (<i>double</i> / </span><span data-if="dotnet" style="display:none">int / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>double</i> / </span><span data-if="cpp" style="display:none">Hlong)</span><span data-if="c" style="display:none"> (<i>double</i> / </span><span data-if="c" style="display:none">Hlong)</span></span>
</div>
<p class="pardesc">3D camera pose.</p>
</div>
<h2 id="sec_result">结果</h2>
<p>如果参数均有效，算子
<code><span data-if="hdevelop" style="display:inline">create_cam_pose_look_at_point</span><span data-if="c" style="display:none">create_cam_pose_look_at_point</span><span data-if="cpp" style="display:none">CreateCamPoseLookAtPoint</span><span data-if="com" style="display:none">CreateCamPoseLookAtPoint</span><span data-if="dotnet" style="display:none">CreateCamPoseLookAtPoint</span><span data-if="python" style="display:none">create_cam_pose_look_at_point</span></code> 返回值 <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
    .  If
necessary an exception is raised. If the parameters are chosen such
that the pose is not well defined, the error 8940 is raised.</p>
<h2 id="sec_predecessors">可能的前置算子</h2>
<p>
<code><a href="convert_point_3d_spher_to_cart.html"><span data-if="hdevelop" style="display:inline">convert_point_3d_spher_to_cart</span><span data-if="c" style="display:none">convert_point_3d_spher_to_cart</span><span data-if="cpp" style="display:none">ConvertPoint3dSpherToCart</span><span data-if="com" style="display:none">ConvertPoint3dSpherToCart</span><span data-if="dotnet" style="display:none">ConvertPoint3dSpherToCart</span><span data-if="python" style="display:none">convert_point_3d_spher_to_cart</span></a></code>
</p>
<h2 id="sec_alternatives">可替代算子</h2>
<p>
<code><a href="create_pose.html"><span data-if="hdevelop" style="display:inline">create_pose</span><span data-if="c" style="display:none">create_pose</span><span data-if="cpp" style="display:none">CreatePose</span><span data-if="com" style="display:none">CreatePose</span><span data-if="dotnet" style="display:none">CreatePose</span><span data-if="python" style="display:none">create_pose</span></a></code>
</p>
<h2 id="sec_module">模块</h2>
<p>
3D Metrology</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
